home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / ifl / TIFFReadEncodedStrip.z / TIFFReadEncodedStrip
Encoding:
Text File  |  2002-10-03  |  3.1 KB  |  67 lines
  1.  
  2.  
  3.  
  4. TTTTIIIIFFFFFFFFRRRReeeeaaaaddddEEEEnnnnccccooooddddeeeeddddSSSSttttrrrriiiipppp((((3333TTTT))))             IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      TIFFReadEncodedStrip - read and decode a strip of data from an open TIFF
  10.      file
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttiiiiffffffffiiiioooo....hhhh>>>>
  14.      ttttssssiiiizzzzeeee____tttt TTTTIIIIFFFFFFFFRRRReeeeaaaaddddEEEEnnnnccccooooddddeeeeddddSSSSttttrrrriiiipppp((((TTTTIIIIFFFFFFFF**** ttttiiiiffff,,,, ttttssssttttrrrriiiipppp____tttt ssssttttrrrriiiipppp,,,, ttttddddaaaattttaaaa____tttt bbbbuuuuffff,,,,
  15.      ttttssssiiiizzzzeeee____tttt ssssiiiizzzzeeee))))
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      Read the specified strip of data and place up to _s_i_z_e bytes of
  19.      decompressed information in the (user supplied) data buffer.
  20.  
  21. NNNNOOOOTTTTEEEESSSS
  22.      The value of _s_t_r_i_p is a ``raw strip number.''  That is, the caller must
  23.      take into account whether or not the data are organized in separate
  24.      planes (_P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=2).  To read a full strip of data the data
  25.      buffer should typically be at least as large as the number returned by
  26.      _T_I_F_F_S_t_r_i_p_S_i_z_e(3T).
  27.  
  28.      The library attempts to hide bit- and byte-ordering differences between
  29.      the image and the native machine by converting data to the native machine
  30.      order.  Bit reversal is done if the _F_i_l_l_O_r_d_e_r tag is opposite to the
  31.      native machine bit order.  16- and 32-bit samples are automatically
  32.      byte-swapped if the file was written with a byte order opposite to the
  33.      native machine byte order,
  34.  
  35. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  36.      The actual number of bytes of data that were placed in _b_u_f is returned;
  37.      _T_I_F_F_R_e_a_d_E_n_c_o_d_e_d_S_t_r_i_p returns -1 if an error was encountered.
  38.  
  39. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  40.      All error messages are directed to the _T_I_F_F_E_r_r_o_r(3T) routine.
  41.  
  42. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  43.      _l_i_b_t_i_f_f(3T), _T_I_F_F_O_p_e_n(3T), _T_I_F_F_R_e_a_d_R_a_w_S_t_r_i_p(3T), _T_I_F_F_R_e_a_d_S_c_a_n_l_i_n_e(3T)
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.